home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr10 / jot14.zip / JOT.DOC < prev    next >
Text File  |  1993-06-16  |  15KB  |  286 lines
  1.  
  2.                      J O T   Version 1.4  -  March, 1993
  3.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.          A Small, Quick And Easy Personal "Note-Pad" For Your Computer
  5.                               SHAREWARE EDITION
  6.            (C) Copyright 1993 by Kirk Lawrence.  All Rights Reserved.
  7.  
  8. If you like to jot quick notes to a disk file, here's your handy answer: JOT!
  9. It allows you to rapidly type a short note and save it to disk, without having
  10. to load a full-blown word processor or text editor.  JOT is not memory-resident
  11. ...so it doesn't eat up precious computer memory.  You can load it fast from
  12. the command line anytime you need it.  JOT also lets you READ the notes in
  13. your file on the screen, if you wish!
  14.  
  15. JOT is not "public domain" or "free" software.  JOT is a fully copyrighted
  16. program, protected under the laws of the the United States and most other
  17. countries world-wide.  JOT is released as SHAREWARE.  This means that you may
  18. make copies of the program and distribute them, provided that all files in this
  19. set remain intact and unaltered.  You may also USE JOT on your own computer for
  20. a trial period of 30 days.  At the end of the trial period, if you've found JOT
  21. to be useful, and you wish to continue using it, payment must be sent to the
  22. author.  The price is only $US 5.00 (cheap!).  Complete details are at the end
  23. of this file.
  24.  
  25. QUICK-START FOR "TECHIES" AND EXPERIENCED COMPUTER USERS: JOT is so intuitive,
  26. you'll do just fine if you simply SET the environment variable
  27.  
  28.       JOT=[drive]:\[path]\filename
  29.  
  30. ...indicating where you want your notes saved.  Then invoke JOT and go for it!
  31. The following documentation is designed for less-experienced users.
  32. But DON'T FORGET TO REGISTER!
  33.  
  34.  
  35. WHAT COMPUTER EQUIPMENT YOU NEED:
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37. JOT will run on ANY IBM-compatible computer...from the oldest, slowest 8088
  38. to the newest, fastest 586 and up.
  39.  
  40. JOT works with ANY video system: Herc monochrome, CGA, EGA, VGA and SVGA.
  41. JOT checks the type of video card your computer has, and acts accordingly.
  42. Total video compatibility is assured, even for Herc monochrome (which is
  43. too often neglected in today's shareware).
  44.  
  45. JOT uses DOS services for all disk accesses, so it doesn't do any low-level
  46. "funny" stuff.  Just be sure that you're using DOS version 2.1 or higher.
  47.  
  48.  
  49. HOW JOT WORKS:
  50. ~~~~~~~~~~~~~~
  51. JOT looks at an environment variable, which YOU set, to find out what drive,
  52. what path, and what filename you want your notes to be saved to.  An environ-
  53. ment variable is a brief line of data, held in an area of your computer's
  54. memory called the ENVIRONMENT.  DOS, and other programs (like JOT), can refer
  55. to this area for information...it's sort of a "road map."
  56.  
  57. If you'd like to see what's currently in your environment, you can type SET
  58. at the DOS prompt, and then press ENTER.  Your current environment will dis-
  59. play on the screen.
  60.  
  61. Setting an environment variable is real easy!  First, decide what DRIVE and
  62. what SUB-DIRECTORY you want your JOT notes to go into.  Let's suppose you
  63. select C:\STUFF.  Then, pick a name for the file where you want to save your
  64. notes.  Let's suppose that the filename you've chosen is MY.TXT.  Now: at the
  65. DOS prompt, type the following:
  66.  
  67.         SET JOT=C:\STUFF\MY.TXT
  68.  
  69. ...and press the ENTER key.  That's all there is to it!  JOT will now know
  70. where to save your notes.
  71.  
  72. You may give your note-file ANY legal name that you wish, on any drive that
  73. you wish.  You don't even have to specify a sub-directory, if you'd rather
  74. have the file in the disk's ROOT directory.  For instance, if you wanted your
  75. notes saved to a file named PERSONAL.JOT in the root directory of drive A:,
  76. here's what you'd type at the DOS prompt:
  77.  
  78.         SET JOT=A:PERSONAL.JOT
  79.  
  80. ...and press the ENTER key.  See how easy it is?!
  81.  
  82. One thing to keep in mind: JOT cannot CREATE a sub-directory that doesn't
  83. already exist.  So be sure the sub-directory you specify is already there!
  84. The FILE NAME you specify, however, does NOT have to exist.  JOT will check
  85. to see if there's a file of that name.  If there isn't, JOT will offer to
  86. create it for you.  When you're asked, just press Y for yes (create the file).
  87.  
  88. If you'll be using JOT on a regular basis, it's more convenient to put the
  89. SET JOT=  command into your AUTOEXEC.BAT file.  This way, the environment
  90. variable will be automatically set every time you "boot up" your computer.
  91. So you won't have to manually type it in each time!  Use your regular text
  92. editor or word processor to write the command
  93.  
  94.        SET JOT=[drive]:\[path]\[filename]
  95.  
  96. into your AUTOEXEC.BAT file.
  97.  
  98. You may change the drive, the path, and/or the filename to which your notes
  99. are saved ANYTIME YOU WISH...merely by typing the SET JOT= command, specifying
  100. the new parameters.  Entering a new SET JOT= command automatically cancels the
  101. previous one.
  102.  
  103.  
  104. HOW TO USE JOT:
  105. ~~~~~~~~~~~~~~~
  106. After you've set the environment variable, just type JOT at the DOS prompt,
  107. and press the ENTER key.  JOT will check for the presence of the filename you
  108. specified in the environment variable.  If the file doesn't exist, JOT will
  109. ask your permission to create that file.  Press Y (for YES) to create the
  110. file.  Once the file is in existence, JOT won't ask you about the file again,
  111. unless you later erase that file.
  112.  
  113. You'll find that JOT is so simple and easy to use, it's easier to just run the
  114. program than to READ about it!  However, complete written instructions follow.
  115.  
  116. At the bottom center of the screen is a "dialogue box."  This is where infor-
  117. mation and instructions are displayed.  The information displayed in this
  118. "dialogue box" is always context-sensitive.  That means, whatever messages
  119. show up there, relate directly to what it is you're doing at the moment.
  120. So if you're ever unsure, just consult the message in the "dialogue box!"
  121.  
  122. The first JOT screen...the Main Menu...gives you three options:
  123.  
  124.    [W]rite a note to this file (the note file you've designated)
  125.    [R]ead this file (display the file contents to the screen)
  126.    [Q]uit JOT; exit to DOS (just what it says!)
  127.  
  128. Press the letter key (W, R or Q) that corresponds to what you want to do,
  129. and you're off and running!
  130.  
  131. If you press [R]ead, all the notes in the file will be displayed on the
  132. screen, one screenful at a time.  To continue reading the file, press any
  133. key except ESC...and the next screenful of text will be displayed.  You may
  134. press the ESC key at any time, to return you to the initial options menu.
  135.  
  136. If you press [W]rite at the Main Menu screen, JOT brings you to the text
  137. entry screen.  This is where you type the note you wish to save to disk.
  138. JOT allows you to type up to 10 lines of text.  As you approach the end of each
  139. line, press the ENTER key to move the cursor down to the next line.  Remember,
  140. JOT isn't a word processor or a text editor: it's a simple little note-pad...so
  141. there's no automatic word-wrap from line to line!  You must press the ENTER key
  142. to change lines, just like you would on an electric typewriter (remember?).
  143.  
  144. When you've finished typing your note, just press ENTER with the cursor on an
  145. empty line (that is, a line where you haven't typed any text).  This tells JOT
  146. that you've finished typing all the text you want to type, and that you're
  147. ready to save your note to disk.
  148.  
  149. At this point, the message in the "dialogue box" will give you four choices:
  150.  
  151.   [S]ave your note to disk.
  152.   [C]ontinue typing more lines into your note.
  153.   [R]e-do your note (type it over again).
  154.   [G]o to the Main Menu; abandon the note you're currently working on.
  155.  
  156. Press the letter key (S, C, R or G) that corresponds to your choice...and
  157. that's it!  If you choose "[G]o to Main Menu," JOT will ask you to confirm
  158. that you REALLY want to abandon your current note...just to be sure!
  159. Press Y(es) to abandon, or N(o) to return to your note.
  160.  
  161. One more thing: if you've used all 10 lines in your note, JOT "knows" that...
  162. and won't present you with the [C]ontinue option, above.  Obviously, you
  163. can't continue typing more lines if you're already at the maximum!
  164.  
  165.  
  166. SOME HELPFUL INFORMATION:
  167. ~~~~~~~~~~~~~~~~~~~~~~~~~
  168. JOT has excellent error-handling abilities.  If a problem ever arises, JOT
  169. will almost always present you with a choice of what you want to do about the
  170. problem.  Or, JOT will gracefully exit to DOS.  In the rare event that there's
  171. a physical problem with a disk, a DOS error message might pop up on the screen.
  172. But even then, you'll be presented with options as to what you want to do.  So
  173. if you're a new or inexperienced computer user, relax!  It's extremely diffi-
  174. cult to ever "mess anything up" using JOT.
  175.  
  176. While you're typing on any line, you can make corrections to what you've typed
  177. by using the BACKSPACE key.  But once you've ENTERed a line of text, it's not
  178. possible to go back and make changes to it.  So if you're typing along, and
  179. discover that you've made an error in a previous line...and you just can't
  180. "live with" that error...press ENTER twice, then select "[R]e-do note" (from
  181. the options in the "dialogue box").  You can then re-type your note.
  182.  
  183. JOT allows a maximum of 79 characters on any one line.  If you attempt to type
  184. any more than that, JOT will "beep" at you, and won't accept the additional
  185. characters!
  186.  
  187. If you need to have a blank line in the note you write, you must type at least
  188. ONE SPACE on that line!  Remember: if you simply press ENTER on a blank line,
  189. JOT will think that you're through writing, and are ready to save the note.
  190. So type at least one space on the line you wish to have "blank."
  191.                  ~~~~~~~~~
  192. For each new note you write, JOT appends it to the specified file (that is,
  193. JOT "tacks it on" to the end of the file you've told it to use).  JOT leaves
  194. two blank lines between each note in the file.  JOT also writes a "header"
  195. before each separate note, consisting of the date and time the note was
  196. written.  So when you view the file, you'll easily be able to tell "which
  197. note is which."
  198.  
  199. You can "start fresh" with a new note file anytime you so desire.  You may
  200. either erase the current note file (naturally, this will destroy all the notes
  201. presently in the file), or you may change the environment variable to point to
  202. a new file name (issue the SET JOT= command at the DOS prompt).
  203.  
  204. JOT saves your notes to the file as "flat ASCII."  You may edit your JOT note
  205. file, using a text editor or word processor program, if you want to.  But if
  206. you do, make sure you SAVE it back to disk as flat ASCII...don't let any of
  207. those funny-looking control codes get into the file!  EVERY text editor and
  208. word processor has the ability to save a text file as flat ASCII.  If you don't
  209. know how to do that, consult the program's documentation (your text editor or
  210. word processor might call the flat ASCII option another name, such as "DOS").
  211.  
  212. You can put the executable file JOT.COM anywhere within your assigned PATH.
  213. Then when you need to write a note...no matter WHAT directory you happen to
  214. be in...you can simply type JOT at the DOS prompt, and JOT will "pop up"
  215. fast!  The drive and directory where your note file is located does NOT
  216. have to be within your PATH.
  217.  
  218. That's about all.  Enjoy using JOT!  If you find the program useful and
  219. want to "make it your own," please register and pay for it.  Thanks!
  220.  
  221. Special thanks to T. J. Leitz, Anita Taylor, and all the other beta testers
  222. who helped perfect JOT.
  223.  
  224.  
  225. COPYRIGHT NOTICE: The software program JOT.COM and this documentation file
  226. are copyright 1993 by Kirk Lawrence.  All rights reserved.
  227.  
  228. SHAREWARE NOTICE: JOT is NOT "free" or "public domain" software!  It is a
  229. fully copyrighted program, protected under the laws of the United States and
  230. most other countries world-wide.  JOT is released as SHAREWARE.  You are
  231. hereby granted a license to use JOT on a trial basis for 30 days.  At the
  232. end of this trial period, if you've found JOT to be useful to you, and you
  233. wish to continue using it, you must send payment to the author.  The price is
  234. only $US 5.00 (cheap!).  Upon receipt of payment, you'll be sent a proprietary
  235. version of the program, personally registered to you, with all those annoying
  236. time delays and shareware notices removed.
  237.  
  238. For your convenience, an order form is included with this package.  To print
  239. the form, turn your printer's power on and set the printer on-line (making sure
  240. that paper is loaded in the printer).  At the DOS prompt, type:
  241.  
  242.     COPY ORDER.JOT PRN        ...then press the ENTER key.
  243.  
  244. Thanks for your honesty in paying for JOT.  Registration of shareware provides
  245. independent programmers the incentive to keep producing quality, inexpensive,
  246. "try-before-you-buy" computer software.
  247.  
  248. For a registered copy of JOT, please send $5.00 (in U.S. funds) to:
  249.  
  250.      Kirk Lawrence
  251.      P.O. Box 2558
  252.      Hayden Lake, Idaho  83835
  253.      U.S.A.
  254.  
  255. Specify 5.25" or 3.5" media.  If a newer version has been released, you'll
  256. be provided with the very latest version.
  257.  
  258. DISCLAIMER OF WARRANTY: JOT.COM is offered strictly "as is."  The author
  259. makes absolutely no warrantees of any kind whatsoever regarding this program
  260. and its accompanying documentation; including, but not limited to, implied
  261. warrantees of merchantability and fitness for a particular purpose.  You use
  262. JOT.COM solely at your own risk.
  263.  
  264. DISCLAIMER OF LIABILITY: Under no circumstances shall the author be liable to
  265. you or to any third party for losses or damages of any kind, type or descrip-
  266. tion whatsoever, including but not limited to pecuniary losses, and including
  267. but not limited to incidental and/or consequential damages, arising from the
  268. use of, or inability to use, JOT.COM.
  269.  
  270. AGREEMENT TO TERMS AND CONDITIONS: By using the program JOT.COM, you thereby
  271. agree to the following terms and conditions: All disputes shall be adjudicated
  272. under the Laws of, and in the Courts of, the State of Idaho.  All costs asso-
  273. ciated with any legal action, including attorneys' fees, court costs, and other
  274. associated expenses for both sides, shall be borne by the person(s) and/or en-
  275. tities(s) instituting such legal action, regardless of the outcome of said
  276. action.  In no case shall awarded damages exceed the amount originally paid for
  277. the program.  If any part of this agreement, the Disclaimer of Liability, or
  278. the Disclaimer of Warranty is subsequently found to be invalid by a court of
  279. proper jurisdiction, all other terms and conditions contained in these docu-
  280. ments shall remain in effect, and binding on all parties.  By using JOT.COM,
  281. you thereby agree to hold the author harmless from any and all consequences
  282. that result from such use.  Your use of JOT.COM shall be prima facie evidence
  283. that you have read these terms and conditions, understand them, and agree to
  284. be bound by them.
  285.  
  286.